sides 'No. of cylinders' On decimal) interleave value: (in decimal) @FREE Syntax: 
Free [devname] U sage : Displays number of free sectors on^ a device @GFX 

RUN 



Svntax: RUN GI 
BASIC09 to do c 
GFX2([path]<funct 
handle enhanced 
Usage : Graphics 
windowing comm 
help to users will 
@IDENT Syntax: 
from OS-9 memoi 

single line output 

directory @INIZ Svn 

@INKEV Syntax: RU 

input a si 

the proc 

memory 

text files 

memory 

directory 

module c 

Merge <] 

©MEREI 

@MODR 

memory 

compare 



AUSTRALIAN 

OS9 
NEWSLETTER 





EDITOR 

SUB-EDITOR 

TREASURER 

LIBRARIAN 
SUPPORT 



Gordon Bentzen 
Bob Devries 
Don Berrie 



ce package for 

Svntax: RUN 

BASIC09 to 

Syntax: none 

die graphics/ 

Give on-line 

of help topics 

r information 

mory -s = use 

at execution 

Itach a device 

subroutine to 

" - [abort to 

lk to a 



(07) 344-3<S81 



(07)372-7816 W ^ 



(07)375-1284 



Jean-Pierre Jacquet 
Brisbane OS9 Users Group 



nory 

ntax: 

iutput 

(07)372-4675 »nory 




to module 

module M - ma«sk TRfk IT , nn^lc TRn* ^MOMTVPF Syntax 

Usage : Set m< Addresses for Corresp onde nc e 

monochrome rr Edit0 n a l M a t eria } : 
and links an Ct _ _ 

Procs [e] Usa* Gordon Bentzen 

display all pro* 8 ° (Sin Street 

current date d SUNNYBANK Old 4109 

execution dired Subscriptions & Library KpqnesTs: 
Usage : Gives 1 Jean-Pierre Jacquet 

module> Usag< 27 Hampton Street 

[yy/mm/dd/hh:r DURACK Qld 4077 

Syntax: Setpr <\ 
num @SHELL SI 
@TMODE Syntax: 
the ope 
[value] 




■ Bnk 

erifv 

Montype [opt] 

» monitor m - 

Creates 

S Syntax: 

Opts : e = 

Prints the 

he current 

filename> 

nb <i-\rode 

ax: Setime 

@SETPR 

process to 

interpreter 

ays^or changes 

>r /p> 
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<modna 

WcreattD 

Initialize ari 

from stdin -s=type = set screen type for a window on a new screen <§>XMODE 
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Here is yet another appeal for 
contributions to our newsletter. Can you help 
to fill these pages with soaethinq which say be 
of interest to other National GS9 usergrouo 
aesbers?? w"e would be happy to include your 
questions here so that someone aay be abis to 
help with a solution. 

Our aesbersnip continues to grow with soae 
53 aeabers spread across every State in 
Australia as well as Papua New Guinea, Geraany 
and the United States. The predicted aove to 
OSK has not as yet been widespread within 
Australia with the majority of cur aeabers still 
happy to run QS5 on the Tandy CoCo faaily, but 
who knows what the future will bring. I know of 
one of our usergroup aeabers who has olaced an 
order for the HM1 but I won't mention his naae 
at this point. 

GS9 continues to hold our interest despite 
the fact that it is far froa the aainsteaa 
operating systes. we all have haci, no doubt, 
soae exposure to HS-DGS. and soae sou Id say far 
too such exposure for their liking, but we still 
cose back to OSS because we aiss the sany 
features of this powerful operating systea which 
are non-existent in other svstess. QS9 and GSK 
can be "fun B as wail as frustratino at Uses. 



yfjcin twines oo wrono* 



■one" 



However, help is always available froa other 
QSS'srs. 

One of our aesbers froa Canberra has 

ijtil'ci'nn tha Ki!T»ta i finri-c Intartira }lr<>± uhan 

one undertakes a project like this, one can 
expect to run into a few probleas along the way; 
aainly because we are suddenly faced with 
unfasiiiar software and procedures, well our 
aan in Canberra did run into a couple of 
probleas which prevented his froa being able to 
for&at the newly added hard drive, and he had 
reached the point of complete frustration when 



he decided to contact ae. Don Berrie was also 
dragged into this problea (not that Don needs 
auch dragging whenever an OSS problea appears) 
and we were able to help out. The hard drive is 
now formatted under 089 , and we were advised by 
our Canberra aesoer that he had tracked down the 
source of his probles. So here is a tip* when 
building a device descriptor for a hard drive, 
QQ NOT set the "park track 3 as track zero ; even 
it the hard drive in question does not need to 
be "parked* or has 'auto-park' 1 . 

This is just one exaaple of how we can help 

airh nthpr anrt + Hi c avnaiManra nil' ?Icn Hair. 

soaeone else, we hope so. 

So what is your particular problea with OSS? 
Or perhaps you can pass on a few valuable tips 
froa your own experiences. 
PROBLEM: I have used the screenduap utility 
"SPrint 5 in assesbler froa the P.O. library 
which is froa Ron Laaaardo. This utility duaps 
a text screen froa a specified window to a std 
cut 3 by default, or allows redirection to the 
printer. Now when I redirect output to sy 
1 underscore character $5F is 



4£P ic ni»intari 



in 



printer, tne 

ionored and the 

reverse. Help!! 

IN THIS EDITION:- 

Bob Oevriss has included C source for the HAN 

utility a la UNIX HAN which allows .doc or 

aanuai files to be listed. This is a verv 

useful utiiitv for hard drive users and could 

ilcn ha h^nH 1 ..' trip ^ il nnr-.v hscaH cjctara it jll 

Manual 5 files were stored on one disk. 

Don Berrie has included soae aore info files 

froa the CoCo list server which helps us to keep 

up to date with developments overseas. 

tfe continue to work on the long promised 

database of the public doaain library, so don't 

give up hope. 

Cheers. Sordon. 
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CoCo-Link is an excellent aagazine to help you with the RSDOS side of the Colour Coaputer. It is a bi- 
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31 Nedlands Crescent 
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Getting SAS'-sy with Your Disks 
bv Peta Lyali 



Whether folks are finding hard disks to be more 
affordable, or aandatery for increased storage 
capabilities, soae coabination of the above is 
causing aore of thea to appear on Coco3 (and 
ether) QSS systess. with ail this space, poser, 
and capability coaes the the inevitable list of 
questions and confusing options. I won't 
atteapt to deal with thea ail here, but I sill 
try to dear the air on a couple of device and 
path descriptor 'options that seea to be giving 
soae new hard disk owners a bit of a tough Use 
- OD.biT (nuaber of sectors per cluster) and 
IT.SAS (ainiaua sector allocation size). 

Since the OD.BIT is a bit easier to cover, let's 
do that first to get waraed up for the other 
stuff. Another good naae for OD.BIT aight well 
be 'ciustersize' . In order to understand what 
clustersize is. we're going to have to dig a 
little bit into the layout of the disk. All 
disks, be they floppy or hard disks, have at 
least three things on thea when they are 
initially forsatted. These are: 

o - Logical Sector Nuaber Zero (LSNG) 

o - Disk Bitaap 

o - Root Directory 

The LSN8 is essentially a sector containing ail 
the information about the disk's personality. 
It contains information on how aany tracks and 
sectors the disk has ; and also how aany sides 

!' : ip Haaric in »ha raeo ni a hai»H .-iicVI a pa 

available. Other inforaation includes the tise 
that this voiuse (disk) was created or 
forsatted, who the owner is, where and how laroe 
the boot file is (if any), the disk naae, and 
lastly the bitaap inforaation. This bitaap 
inforaation tells the systea how aany bytes are 
in the bitaap, and what the size is in sectors 
(clustersize) of the space that each bit in the 
sap represents. Hore on this in a amute. 

The bitaap is basically a aap of the space 
available on a disk. Each bit of each byte in 
the bitaap represents a block of space on the 
disk. One analogy to the bitaap would be the 
seating chart you aight see in a restaurant when 
you are in the reception area. Tables that are 
aarked on the chart with an T, or possibly 
illuminated by an LED, indicate that the table 
is in use. 



Tables that are not explicitly aarked are 
available to be used. Huch is the case with the 
bitaap. If a bit is on (in the ! i l state), it 
tells the systea that the block of disk space 
that it represents is in use. What the space is 
used for is of no consequence to the bitaap. It 
could be part of a file, a directory, or even 
part of the bitaap itself. Conversely, an off 



bit ( ' $ ' } 



indicates that me space is available 



for whatever needs it. 

Notice that I have sanaged to avoid defining how 
big this space is. The reason? It is variable. 
Each bit in the bitaap represents one cluster. 
The size of this cluster is defined in DO. SIT in 
LSNO, which is read by the systea before any 
other aanipulaticn of the disk is done. A 
cluster Bay be froa 1 to $FFFF (65535) sectors 
in length. 

Ready for a surprise? Alios t everyone uses a 
cluster size of 1. So why bother with all this 
confusing talk of clusters and sectors? There 
was a tiae in 039 history when lower density 
floppies were the predoainant storage device. 
Ta going to hazard a guess and say that early 
osS prograaaers decided to liait the length of 
the bitaap to 1 sector, thinking they wouldn't 
need any aore. After ail, if we consider the 
case of ciustersize = 1 sector, and a forauia 

of ! 

{'TPnrV'QtvKrTnwv/PTTCirkapwVTf'i in mCTm}Q7~f = 

BITMAP SIZE 

a singie-sioed 35 lrac£ ; aoubie density drive at 
IS sectors per track (standard osS foraati only 
reouirea 76 bytes of bitaao space (35*16/3?/!, 
and a single-sided 77 track 3 inch disk, at 2b 
sectors per track would fit into 251 bytes of 
bitaap space (77*26/8)/!. 

The probleas caae with drives of higher 
capacity. A conventional double sided §9 track 
drive would overflow the bitaap sector 
((86S16S2/8)/! = 320 bytes). You can easily 
isagine how a hard disk aight affect this 
situation. Enter clustersize. If the 
clustersize is set to 2, each bit in the bitaap 
now represents 2 sectors of disk space. In the 
case of the 88 track floppy above, this alters 
the forauia to C(8ttl6*2/8)/2 = 169 bytes). At 
a clustersize of 2 sectors, the bitaap can 
represent roughly I aegabyte of space. 
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jdviousiv trH i = is n r= t. laroe ersouon *or ^ven the 
have 'o be raised to :^ sectors to re^res^r.- s 5 

ripriijVifT a :1ri-:ia in ^ nn& cart:-iP hitman £\->p j '-'H 

s9gaby te drive, each bit in the bitsiao would 
have to rsoresent 40 sectors, and it gets 

np^niiicsivfiii/ 'jr.pca 1 1.1 1 it K l^pnap Hpi'vpc Tj- , - •>; 

where we can start to see the flaw in this 
desiqn. Suopose you need to create a very short 
nprtrotjnrp fiio that were to c Dfit-d 1 Fi *he command! 

echo This is a test')/t2 

This file should require only about 25 bytes 
including the carriage return. Because the 

Kip.-ibisra ftPo^aTit: sic tpn» ncinn inuth'jrin era:! 'lap 

than a sector, our file size ail I be 25 bvtes, 
but the disk space used should be 1 sector. 
Assuaing that we had done this on the 20 
aegabyte drive described above, we would 
actually have used 4d sectors of disk space (Id 
kbytes) - a waste of 39 sectors. 

Why 7 because the mini sua chunk that we could 
Bark as used or available in the bitaap sas 40 
sectors, yhen we Barked the area as in-use, we 
also sarked the rest of the cluster as in use. 
What a waste! 

Fortunately, ilicroware felt the saae way and 
altered the bitaap design. Now the bitaap aay 
be acre than one sector in length. In fact, it 

Pisu hi iirv in SCv^C hwtac innn f'filQv Cirlnrcl 

mat f t_ id kj w vv V- w w t v w w * *J 1 1 1^ ■. -J i -■ 4. ^ w w v -w i w r - 

The number of bytes in the bitsao is also 
specified in ^ SNO in OD HAP if clustersize 
were 1 sector, this bitsao would be large enough 
to service a .38 aegabyte hard disk. 

For laroer disks, the clustersize has to be 
raised to accomodate the capacity. A 
clustersize of 8, for instance, could handle 
aore than I gigabyte of storage. The current 
bitaap size and clustersize ceiling is capable 
of supporting a disk that contains i .373,74) ,824 
sectors, or approximately 25b gigabytes. 1 
think it should last us for a while, eh? 

That's probably all you'll ever wanted to know 

l\-bp anpa't akiiit rlijctorciTfl Pap alnpct all 

practical purposes, it should be left at a size 
of ! sector per cluster. This is sufficient to 
support those of us with disks that are 138 
aegabytes or ssalier. 

The 'IT.SAS', or segsent allocation size, is 
used to detersine how much of the disk's real 
estate is given up each tiae a request for sore 



aiS\ soace is saoe. i^is ite's is located in tne 
HavH.-j jesc r i n t-^r *"^" ii! "~; di c r- at -vte oMs^t 

$'VH iilHu "=-;!■ inct * : f. '.- i the ,* i 1 1 i no nporacc ip.p 

Qpf> r acciE ; ,5 sector a^ a tiFse as tnev ne^d it 1 ' 
In a word - fragmentation. That : = , your file 
could eno uo Deino severely scattered -ver tne 

d 1 5t ! ^ cnpfsra TK -i c aaanc that ^ tsi'e: rjn-a 

tise to read it, as several seeks to different 
locations on the disk aay have to be sade. 
Also, you could potentially run out of segsent 
2so soace Briefly a ach file and directory has 
a sector set aside for it that describes its 

rnarac* 01 * i ict i ire This i= ynn^n ac tho 'til a 

descriptor sector', or F\i sector for short. 

In the FO sector are data concernino the owner 
of ih^ file, the dates of creation and last 
modification, the peraissions, fiiesize, and 
lastly, a sao containing a list of what sectors 
the file occupies on the disk. This sap has 43 
locations available. Each aap location reserves 
three bytes for the logical sector nuaber of the 
segment (LSN), and two bytes for the nusber of 
sectors in that seasent. If the disk were 
reasonably full and highly fragmented, it is 
conceivable that you could fill up a segsent 
list with 48 entries of one sector each - a 12K 
file would cause an error 217 (Segsent List 
Full). In order to avoid this, the RBF aanager 
tries to reserve a certain asount of sectors for 
file exoansicn ^ach tise a file ne^ds sor c roots 

Thp rjMmhap Qt Cirf.-pc tQ ha added to the file is 
cnar-i t ^ a,-i in IT '-'6v T.-.p rariCt ih-nr,u Ai c'vz 

_■ ;_' 1_ i. i i * WJ ill 1 i .■•■IIV. 1 ■-- I UI -_■ J V I i-JU^i U 1J :'. J . 

this nusber is 3 A oo-d rule of thusb is to 
use sose even fiiuliioie (or division* of the 
nusber of sectors available on a track. 
Standard OSS floppies nave IS sectors per track, 

2p.i-i T '• n rtnpccinp -hi? ; c whu i Ha tan If '-■&-. ?nv 

-i l l --S 4 :ri UWL JJAIlU '.- 1 : -^ J ^ Wilt '^ *-fcW * u V i V V ■:<-- 1 V \ 

1 1 -,r.rii ac ic '?. zarti---c :'r : r,a hsif .-it i tpirl-'. T 

: ''.'yli'. j i J -J J ■_ i. v •-■ i _■ ■.•in. i i a i i J \ u v i m. i '. j . i 

hat if they'd ihouoht ":f it they would have 
aade the SAS value for Color Coaputer forsatted 
disks 3, as that disk foraat has 18 sectors per 
track. Since aost hard disks have 32 sectors 
per track (25b byte sectors). IS and 32 are 
coaaon values for IT.SAS in hard disk 
descriptors. 

Allocating extra space to a file does not chance 
the file's size. If the file is only occupying 
35 bytes of the 3 sectors, its fiiesize will 
still show as 35 bytes. The rest of the 8 
sectors is only standing by for use as expansion 
space for the file, but is not yet in use. It 
is however unavailable for use by any other 
file, and is aarked as being busy in the disk : s 
bi * aao 
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3v "'OS vou're or^bdwiv thinkin^ thai, this ^ ; 
horribly ^ 3 = t s T " u I aooroach. Here 1 ? ?.h^ r^t 



vour neaas wouio nave u 



^nei 



■ iC'itfi 



!-,G 



sill 



*n iha *"*aa :r.;ra n.-i.-i ] * f t*- : a tila "iv'mar wzz 

at the end of the file. That is, if ye had 
written the 35 byte file above, our write 
pointer would have aoved forward one byte si th 
each character we wrote to the file, yhen we 
wrote the 35th character, and then closed the 
file, ye were at the end of file. As a result, 
the bulk- of the reserved expansion space (in the 
case of a floppy. 7 sectors) was given back to 
the systes. 

This is wonderful for files that will be written 
or updated infrequently like ASCII text files 
written with your editor. If you think about 
it, you are not changing existing files, but 
writing out a new file and deleting the old one 
each Use you edit. This is not so wonderful 
for files that are continually altered or 
expanded, like database files. These are the 
files that reallv need orotection fros 
fragaentation. 

Fragmented database files (or directories) can 
sake for extreaely slow search or lookup 
operations. what can be done to effect this 
protection and hang onto the reserved expansion 
space? Sisple - just sscve the file pointer to 
any place other than the end of file. This is 
normally done with a seek cosittand: aost cosiaor.iy 

^ p ; 1/if itirin H in fha tila file." L-'Tv-Mn ic 

'rewinding 1 a file), when the file is closed. 
whatever space had been allocated to it as 

avrjsnciun «a'=™ i e t'ont Trip fiitiipa iic& anri tint 

returned to the free soace pool . 

This technique is used by the system in the 

r?ajtinn jt Hi r ar t Qp |ac EaCH tlSe { HAKQ I R * IS 

run. it allocates the nusber of sectors 
specified in IT.SAS" for that disk to the 
director" vou create Even though the filesize 
say be hi (rcos for the f . ; and \. ! entries),. 
the allocated space will be several sectors. 
This will prevent your directories fros being 
scattered in several tiny chunks over the 
surface of your disks. 

Could you iaagine what the iapact of having a 29 
sector CMOS directory that was fragaented into 1 
sector pieces? If you typed 'dire' instead of 



Hi -, 



ses 



at least 



rssue an error 



There is a soaii disadvantage to this philosophy 
as well H vou are creatine directories that 
you know in advance will only have a few files 
in thea : that extra directory space will be 
permanently wasted. For this reason, ! wrote a 
variation on the ; HAKDIR ' coasand called : skdir : 

("iiniv inr! M^-HnQ ;i:ai>e Hi\/a nna - why nnt 'J c '? ' 

Hkdir allows vou to scecifv either the nusber of 
directory entries you wish to sake roos for, or 
just how sany sectors you wish to reserve. Also 
available is the source for a utility called 
; fsap ! (file sapper). This utilty was written 
primarily to allow inspection of the FD sectors, 
but is also useful in lookinq at a file's 
allocated space vice actual filesize, and its 



i he sources to both or these prcgrass are froa 
early C prcqraasing efforts. and are 
consequently soseahat inelegant. If I let that 
stop ae ; I'd never publish or post anything, so 
here they are! For those without access to a C 
compiler, the binaries are available for 
downloading froa the OSS Forua on CompuServe in 
the UTILITIES area (DL9). [Source and binary 
files are available froa the our PO Library .. 
edl 

T K!-ir.a tHst T havfl m-nanari *n chorl a 1itt!a 

t 1 i'W W_ l'l IU V J. hui w -Jiw 1 1 V^ '*. 'J V W *% lb U Q * * V V * _ 

light on sobs of the less obvious areas of disk 
aanagesent, and possibly even desystified the 
disk bitsao and the nature of IT.SAS to soae 

Har'T'aa T ^re z'\:-.tzyz jvailshTa \r\ ?ha HVV k,-!«|tm 

'jw j i '- u . • um -i i wj 7 j jiQiiaw*!- lit l-iiC ww j i -v I Ufai 

on CoaouServe for questions and consents (as 

a* t Sap 'Vy = nr ; qt 'Pat^a LVall' ~ U C "T ^H' 

7b7#3.4223). and I check into the Delohi OSS 
For us at least weekly under the use masse 

'ossuevp 1 . 

For those with access to USENET, I can be 
reached at iscgvax, ihnpi. jpigodoliwibripete or 
on the Internet at oete^wlhr.eaton.coa. 



Please feel fr^e ^o r ^n* L ct 
questions you say have. Until 



se with any 

tha navt t -i x-.a 

happy hacking, and reseaber to backup your disks 
before getting too creative! 
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I hdVS al^SVS felt that those of US *?ho 

oatronize th8 ~'ub lie Qoaain Library sus?- have 

nijii'P 3 Karri -i rift t-'pen-nn rvzrv ,-, t whira ;:■ 

those document files are. Those with hard disk 
drives, of course, can put then ail togetner in 
one directory. But then to access thes quite 
often iseans to have to type a rather long 
■caargand line, especially if the directory is 
soae way down the tree. Something like 'list 
/OQ/uSR/uGCS/ar . san : . And then you have to 
renseaber shat is in the docs directory. A bit of 
a pain really. 

Recently. I case ac cross a prograsse which 
solved the Drool ea for ae. It sas an Aaioa cort 
of the UNIX prograaae 'MAN 1 . The prograaae : 
complete with document files and source code 
case from the 'Fred Fisfv collection (a 
collection of sose ibt 1 disks of ?D for the Aaiga 

at 'A'AVtk' r,ap Hict-'i T thr.iinht it ainni-i ho a nnrvri 

U V WWVf. U W i '^ L ^ r\ J , L uilvuutiu t v ItVUiW WW Idl ^ww 1 ^ 

evppriea tr pa-wpita tha crmp ro rr-.ria shirK. u:: 

of course in C. for GS'3. weil : it turned out to 
be relatively easv. as the code is not overiv 
long. 

The prograsse is quite versatile. You say 

cnarify thp rti nor t .-vpy nifh fnp thp H^rij^ont c 

and also ih^ 1 oroorasse sith shich to list thes 

rm the r.'iffifiin.l i i np Tha nnnnrsuBO'c rtafanltc 

vil vil" bJmniutiu i i ri C . i II i_ ij I vj ■. H :n in w -> -n_ i G U J. 1/ -I 

apo' 'lict 1 *" : " :r ' Hicnisvinn thp filoc an-l 

O i i_ t i i w L- ■ w l -j i _i >.- i u t J. m • -I v I I C * * I- -J . 3i:-4 

' r ; nft /Mfljy ' ffrr tha Hipor f.ripy f.n ^ ftf>t" f;"P tha 
.•irij-if'ftopt filGc Mr. cr.ariii aniiir.5ant ic panni part 

to cosipile the procraaae (except for the C 

rrifr.ni 1 ap i"v + r : ri?ca I 

Costsand li- a motions are as foiloysi 

-\/ cnar i f u a nau f i 1 a wioypp 

-f display the first Kp.ua I page only. 
-p add a path to the path list, 
-d display path lists. 

The prcgraase can get extra path information 
frora the file called 'aanuals : which is kept in 
the sase directory as the decusent files. You 
say also specify a viewer prograaste there to 
override tne prograaae : s defaults. 






le is laza out ims *ay 



PATH 


/ D D / M A N / 


PATH 


/00/SYS/ 


VIE'y , 


laore 


START HAN 


ar 




jp-h] 


ive 


ed 




END MAN 



/' 00 / H A N / a r s a n 
/00/riAN/a?chive.nian 
ied /00/MAN/eddccs. txt 



There aust be 2& characters and/or spaces 
beUeen tne first character of the program 
nase and the oath to the decusent file 
inclusive. So in the first exaapie: 

ar /00/MAN/ar.aaR 

'--29 characters—' 

You sill notice that the third orocrasae has 
an exclamation sark in its path list. This is 
done so that a cospieteiy different prograasje 
(ed in this case) sill be used for that docusent 
only. Hake sure, however, that the prograaae 
sectioned in that line is in the current 
execution directory, or in aeacryj or it will 
not run, and will not return any error (I sight 
fix that later) 

rictf to the source code. You will notice that 

" haufi Iptt rha rr,ria i-n c:\rh z hju ^h^t it 

L iiOfw * i. I v V I : i_ W WWW ill JUI.II U Pill wliflv i V 

ci-inn T ft Pu-rnisni !a r,n t Ka lain; eti'm sc yott ;c 

wiEwul'w t |_ WWU4WA&W 'J II vilw Utt^UU «l W A i A . Q ^ Il.il '3-1 

■.in Thp n^4 suetuB T.-i r^nrtila \m\t =^r>^jfi nca 

wii ^iiC uww ^ i ^ v^ltl . i -J w'wElwA*w r tvl* jliUuiU ^i^i. 

the cossand line s»i*ch ; -H r,c '^ i yh^ r h h 3 s the 

-jfto af fart zc z lina in t>-a c-iiirra yKir^p -r^s/c 

■li^ating o c -S : So the C-Ssoii^r "osssand lin^ 
looks like ^his! 

cc san.c -dos9 

Without further ado. here's the source 
listing, yhich is of course also available froa 
our PO 1 ibrarv 

Regards, 
Bob Devries 



/ttt«tttt«ttatt«ttt«tttt«tt««tttt«ttt«ttjt«t«««jt««tmv 

i Man VI. 2o t 

t Copyright (0 19*89 by G. Slendcwn t 

t i 

t This prograa and ail docuaentation is placed in the public dosain. t 
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%'Ho !£- D fi'-sv b& ^harn^d 9xc9Dt f-r mcdis an- c^ovinG ArcPr& n isay D9 -T 
-■ in^iud^d on F?£;i Fish's distribution disk Any M-hsr P0 - C!" ! Ii&<"inr % 
% yill h^va [■''■ oat isv ^tr?rissi^n Dfi^r in nuttin^ Nan on his disk c - -t 

j Cny r.ai S9PViC5 fSSV distribute Hd" S5 | Q T; P 59 nn too tnp ^. 

^d-s/r loa^i no ^s r h3?npd ("'xprr-t n^risil iin& c—^-ts' vnu rs?av Tsaka anyt 

T ■ r hd r Q6S tC *S n blit I y^U^d -iDC- r '&!" ■ dtt 1 ?- j* yf:y L i":U : -^ S9 n d £9 t^ ? 

i r^iJ ur;;r^pc ('9":<C9 r :J- rOTlVt:^^iOHS f.H LattlC6~^ ^ ^ fl^dii I d~ I ! ? Mp ct -t 

f iiict w cj-;.- t pt Huts dbi"'U'- tfhal V-U did - 

j J. 

% ?jpprv ; jn Pn d&diH^S' % 

j pjgjcc r9id t.hs tile ' GsrssnDi 5 t-f ^ buti-r ' t 

^:o;:i:i;rro:Y+;j^ 



-f L-b-i; +• 



m 3 ti i / 



nan 



t; Mr. i v-q ty J ci jjfj-fjtidi C "'ft&dfid C ^H'-PO I i^d C -&D I 8*6 i V =v 

i tha fiJP " ft"; .-f Fi ! fi; i H U d I 5 s 

i USAGE; 
■t 

r s;5>i <»'3r;UiI > C - y T 9 :- 1- V 1 9 i ! & P ] L^DPat-hj [-(1 

T 



Ida? ina LINh h I c 

ii;j9finH rlAXCGN '£ /i Maxi^us s 1 z- c ' '"if cnin&an^ naffi^ ?/ 

aHy fir-e EfIFTY " n 

^d&tins FNFOs 2y ■'T- start o^s^ti^n of Gossand I ina-'fi I & n fi ffs & %/ 

?ifdef asioa 

tdafina riANFILE "isan Manuals" 

'■■■-'- ' -"■- -■•■'■ - Crt * *■■ ' Vl --' I 

Sgndi f 

£' t ci •= t os^ 

#def ine HANFILE :: /DD/nAN/m5nLidI s" 

sdaf ir& EXIT e x i t ( 6 ) : 



fx wn^ o^ant this if ynu d^n't hava ffiv I i b r 5 r v with a nay P r* i r* ^ J~ ?•-' 

tfiptinp Pr- 
int cnt. fu 



cHptinp FrintF "rirstf 



FILE ?fh j-fopenO; 
char -t-f G9 is : 

char I ineLLINEJ £ wLMAXCOti<< ! 1 

char pathC 1 1 J L 1283 : 

# i f def aaiqa 

char cB9ndL!2S]={ ii pun I95S "'. 

tendif 

#i fdef os9 

char £Band[]283="liEt = ; 

ijandi f 
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n» Kt j}ii: = H 



int pt; 



har Inifta 



f 1 TuE T 053 

#ds f : hh ACCESS READ I 

T ft 3 j n t 

jjr QqhC i[] crsnninn f.f fhe fj_T n ipLfjjui arc D " I H ^ S t!~ : 9 DStbS d. Q f "i fi^G % 

■?- 3Hd ^hcs'ks the ' E3nUdI s ' - f i If J- 

^ a i n ( a p o c s r ^ v ' 

* . i -.- a ■. y ^ . 

char iarqvi]: 



i pt t • 

*i f dS f OSH 

cut hut i'ct H.->nf win i 't ■ 

Seridlf 

i f ?'irnc (-1 ) 



mi!- ruse 'is marr to see usage o! %5\n" ^rgvl^j f argvL^j , ! f txi i 



n3S5= f c ha r * ' NULL ■ 

t q r { i - ] ■■ f < "3 r n r > t + + ) -f 

if ( a r q v 1 1 ] i y ] == : - f ) C 

5 y i t c h (toupper(arGv[ti[]])) i 
case 'V ; 

strc^Vi's U5jf!ridi4] ) iiarcyi tl['2 1 ) ) * 
strcaticssrsd,"' \(r); 
Status ~C:?STQi1vIhy ■ 
break; 

=trcpy(paih[plJ,£argvLt3[23): 

pi++: 

break ■ 
cBSe : F j ; 

Status =FIRS7QNLY; 

break; 
Ease '9 1 \ 

Status =OISPLAVPATHS; 

break; 
default; 

PriitiFC "Illegal option 'k' ignored\n" I argvEtJEI3} 

break: 
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ise 

riaraa = --riTs/r t 1 



Ft i n t-F i s No ^anua I soec i f i ed = \n " ) EXIT 



j f (sf.3tijcinTvpi_oyP^TpC: i ( 

Pr 1 fit F' "ildFr Paths ! \n" ) ! 

PrintFi" X5\n" Oath[t3); 

P t ■ ~: t P ( '' P ■: ! p - w ■: OfciG r- ' 'TcSn" - fii t-n-ll 



i05tJ \ ! !; ; 



PVTT 



itrncoyi'tf . nase HAXCOH): 
cf.rr jf'y E'IPTV ) ' 
do { 

2 f {' I \ r - f n£ t 5 Ming Li NE f h ? J ' 

P -■ i r. f _;-(' "Qrtric I H 3 H L' S I — f t I -" COrFUC-t ' \n" ' S^'tngaJg*: 

j f (' c t, p nc s r s ( I i n*-* y s i r I ° n ' y ' ) == 6 ? ( 

rnt++ ' 
fc-H-; 

DispIdyFiip(&IineLFNPGSj); 

if iStatus^FIRSTONLY) { 
fciose(fh); 
EXIT 



if (sl^ncsoi 1 ing "tND f1AN ;r 7) == y) exinase' 



i.ihi ic M 



* ex I 

•t Tins routine looks through all dE fined piths to find a file that * 
% will match the filename qiven. i 

i Parameters: ? 

I - naise of the manual file (char i) i 

ex(t) 
char it: 

'' r.t n ■ 

it (rnt r z=W) { 

tifdef aieiga 

ii (FoundCsan:",!)) { 

strcpyCIine/Rsn; 8 ); 
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send it 

fli tHfif >"CM 



tendit 



strc^vnine " /Du/HAN/" ) : 

slrcst =" 1 itif i '? : 
Di^olsvFi 1 e( I ine) : 

if ' F o u nd f o ^ ih l g J i-H ( 

ctprnyMinp Dd^hL'j)' 

c t. r c a t ■■ 1 1 ' r e t ' : 
Oisol avFi in ( 1 i hp ' ■ 

if !'"t:li ;c if T p 1 -: Tfi»ii V i n: r-A 



fr'» p r i pt Pf"Wf: rc =■ r < " =■ ' <= :*■■./ j i 1 Lh ] a ! \ r, " 



; ; i t ■_ n ■ j , 



it i iU ■■ !c I rise! tn 



i Found t 

% This routine checks if %h& file is accessa^Ie in ?-he dir^i't^ry % 
X given as a parameter i 

iiiiXititixiHiiiUXiixtiii'M 

t F'arsiseiers : + 

i. - path which is to be searched (char x) i 

i - filename to look for (char %) % 

% Result: i 

X >!< if file is found i 

j )0h file not found t 
\UiiUix%mi%Hiti%ii%iimtU^ 

i-l F^und i' r ' n) 

■"har % n Tn* 
f 

char f [256 J ■ 

fitdef asiga 

struct FileLock Jl iLockO' 

f endi f 

lifdef osS 

int I; 
send if 

sircpyif ,p); 

strcatCf.n); 
iifdef saiga 

I =Loc k ( f , ACCE3S_READ ) ; 

if il) UnLock(i) I fc++; 

if (i) return(l); 

else reiurn(tj): 



Page 10 April 1991 



AUSTRALIAN OSS NEWSLETTER 



ftendif 

fli ffic-f ,-cQ 

it A I Vj -_ 1 _■ _< _• 

iiLrruccif ACCESS READ? 
it (1 ~" -\ ) relurruO) : 



w|cp r-wtjir-n! | 



senai? 



i DispiayFiie i 

'-■ ^"hi c - r=" ! U^ ifi-" will Csll £it.h Dr ' thfi f 1 1 : "' '''i'l'^'-ilB*' '~i? 1- is 1 ; II t? "* "6 l u ?■ -^ + 

J th fi C05;^irsd SUDDll££ t 

t ~~ Writ; includes f =, ith5" ins f i I & n 5. sr* t or f-h& iir;6 t- !_! &? 9^£cut-9d + 
■ ixxxiixxxxxzzi:.xx%tijxxx% t i 1 1 ? t * -t t _t t ?" ^ '^ -t t ?- 1- .t i x * t j: -t ?- x ^ .?. i .t .t t ? + -t s ^: .t ^ t t t t t ^ ; : 

DisoIdvFi Is( f ' 

rh^r i" t" > 






It UT==' : ! ; 

Esscuis '■■ zi I M 0L ^L^' 
8159 1 

do { 

i + t ; 

} yhile ((tit]!- : : )ii( u t] ! = ! 'v 
5ircpy(exec ; c&aind); 
slrncaKexec ; f t V) ; 
P r i te t F ( " % s - \f); 
Exscuie(ex£C OL 0L): 



f %XTXXX%XX%Z%XxX?Xr?x^ 

tThis r^utin- 3 sc^rs Ihs ^idnuils 1- !!!^ tor th-" PATH and v'lty L^ftm^nd^? 
x and tries to find the '"START^HN'-coissaand. ? 

J Parameters; i 

f - f i i unr, i n -f w -i t r. + Ko ! » sr.i i i i q s - t i ! a "!" 

:-; g s r c h S 1 3 r t f f h ) 

cttmiM Ti I u.UjnH; p if*h ■ 

-J V I tl 1_ V > 4. i w : I m i I U 4 C Till. 

char I ins [LINE] %z ' 
for (;;) { 

if (c=fget5(Iine J LINE 1 fn}) ( 

\* I'ctr.nrpr.flir.o a Q7£P7 WCN 5 Mlzztt'l rot up n- 
it let T-r.r tir, l' 1 i np S 'J~.£U> * $ \ z = 9 I ( 

it '.JirMlLiiiiJ '. nut | (iL« i / ' v ' v ' * 

if ( (Siatu£iCUSTuHvIEy)==y ) { 
strep y ( c fif snd , & I i net. 5 J ) ; 
cmmndLstrlenCcsmnd)-] J= ! s ; 
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if ri[j»D f i in& "PATH " S'—O) { 

5trrDv(Ddth[Dt],MlTltL5j) 1 



Hn fShHV r-iiric ^ 'ft^n ■s;r ss :c' - n:P'\ry 



Sli39 T 053 

bX9CUt-& tSXSC dus'i»iv] dUGiSftv2 '■ /?■ ^-hls r9'"ilii r"^' t- "PHli; 

/ i n r : - - e- v j c t i n t i r. ; - ■: Q Y / 

char +9X9C; 

1 fFflf duSifoV ! ' 

long dui!!Ky2: 

c yet cm I pvg-r "l ■ 



noooot,nf!";r:0nU!jQG^G00"!n^r!O!ir'nn*! 
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